<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 transitional//EN">
<html>
<head>
<title>Embedded Image Structure</title>
<link rel="stylesheet" href="../style/style.css" type="text/css"/>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
</head>
<body>
<h1>Image</h1>

<p>Holds an image embedded within the design file.</p>

<h3>Description</h3>

<p>BIRT allows images to be embedded within the design file. 
This is most useful for reports created in an external application and submitted 
to a server for immediate, one-time execution. If report designs are created 
with the BIRT designer, and are saved on disk, the developer will probably find 
it easier to use external images referenced with a file name or URL.</p>

<h3>See Also</h3>

<h2 class="property">name</h2>

<p>The name of the image within the design.</p>

<h3>Description</h3>

<p>Provides a name for the image. The image name is used to 
reference the image in an image item. Image names must be unique within the 
report. The image name can be any legal name, it need not be related to the 
original image name on disk. That is, &quot;Logo&quot; is a fine name, it need not be &quot;corplogo.jpg&quot;.</p>

<h3>See Also</h3>

<h2 class="property">type</h2>

<p>The format of the image.</p>

<h3>Choices</h3>

<ul>

<li><span style="font-size: 10.0pt; font-family: Arial">image/jpeg: </span>JPEG image:</li>

<li><span style="font-size: 10.0pt; font-family: Arial">image/bmp: </span>Windows bitmap:</li>

<li><span style="font-size: 10.0pt; font-family: Arial">image/gif: </span>Compuserve GIF format:</li>

<li><span style="font-size: 10.0pt; font-family: Arial">image/png: </span>Portable Network Graphics (PNG) format:</li>

<li><span style="font-size: 10.0pt; font-family: Arial">image/x-png: </span>??</li>

</ul>

<h3>Description</h3>

<p>This property defines the type of the image using 
standard MIME types. The type can be omitted. In this case, BIRT attempts to 
identify the image format by looking at the first few bytes of the image. Many 
image formats provide a unique &quot;magic number&quot;. However, this solution is not 
guaranteed to work for all images and all image formats. To avoid problems, the 
application should specify the image type whenever possible.</p>

<h3>See Also</h3>

<h2 class="property">data</h2>

<p>The binary data for the image.</p>

<h3>Description</h3>

<p>This property contains the image itself as an array of 
bytes. The data is stored in the XML design file using base-64 encoding.</p>

<h3>See Also</h3>
</body>
</html>